home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 090 / list548.lqr / LIST.DOC < prev   
Text File  |  1985-06-05  |  9KB  |  218 lines
  1.                                                         LIST     Page 1
  2.  Command  LIST
  3.  -------------
  4.  
  5.  Purpose:  To display the contents of an ASCII text file,  line by  line
  6.            with the aid of scrolling and positioning commands.
  7.  
  8.  Format:   LIST  [d:][path]filename[.ext]
  9.  
  10.  Remarks:  An ASCII file of any size may be listed.
  11.  
  12.            The "filename" is optional.  If omitted, you are prompted  to
  13.         to enter  a filename.   You may  include drive,  path, and  wild
  14.         cards in the file name.   The first file which matches  the name
  15. |       is displayed until an end-of-file character is encountered. Each
  16. |       file which matches the "filename" may be displayed.
  17.  
  18.            LIST was  designed to  display ASCII  files.  That  is, files
  19.         which  contain  text  and  not  binary  or  control codes.  Text
  20.         characters usually range from a value of 32 to 127.
  21.  
  22.            Characters  below  32  (a  blank)  are  replaced with a funny
  23.         character to indicate that a non-displayable character has  been
  24.         encountered.  This character is an upside-down question mark.
  25.  
  26.            Characters above 127 may be valid graphic characters, and may
  27.         be displayed if  the '8' command  is in effect.   To insure that
  28.         characters above ASCII value 127 are not displayed, use the  '7'
  29.         command.
  30.  
  31.            The  file  is  displayed  with  one  logical  record  on each
  32.         80-column display line.   A logical record  ends in a  linefeed.
  33.         The maximum logical record may  be 255 characters long.  If  the
  34.         record exceeds 80  characters, you may  view the portion  beyond
  35.         the 80 columns  by using the  scroll right command,  or by using
  36.         the Wrap feature.
  37.  
  38.            The Wrap  command toggles  ON or  OFF the  wrapping of  lines
  39.         longer than 80 characters.  With Wrap on, lines are displayed in
  40.         their  entirety,  80  characters  per  display line.  The scroll
  41.         -left and -right functions are disabled when Wrap is ON.
  42.  
  43.            The file may  be PRINTed as  it it displayed.   The P command
  44.         toggles  the  printer  on  or  off.   When  first entered, the P
  45.         command causes the current screen  to be printed.  As new  lines
  46.         are displayed, they too are printed.  Printing may be stopped by
  47.         entering another P command.  The PrtSc key may also be used, but
  48.         the title and prompt lines will be printed with the lines of the
  49. |       file. Empty lines cause a line to be skipped on the printer.
  50.                                                         LIST     Page 2
  51.  Key functions and Commands
  52.  --------------------------
  53.  
  54.         On the COMMAND line, enter a letter or control key:
  55.  
  56.         Letter(s)     Default   Function
  57.         ---------     -------   ------------------------
  58.         A                       find next occurance of 'text'
  59.         B                       skip to end of file (bottom)
  60.         D or +                  scroll down one page
  61. |       F                       Find 'text' regardless of case
  62.         H or ?                  list commands (HELP)
  63.         K               off     toggle keyboard flush
  64.         L                       scroll left 20 columns
  65.         N                       down one (next) line
  66.         P               off     toggle printer on or off
  67. |       Q                       display next matching file
  68.         R                       scroll right 20 columns
  69. |       S                       Scan for exact text match
  70.         T                       restart from first block (top)
  71.         U or -                  scroll up one page
  72.         W               off     toggle wrap of lines over 80 chars
  73. |       X                       terminate and exit to DOS
  74.  
  75.         7               off     turn off high bit (non-graphics only)
  76.         8               on      leave high bit on (graphics)
  77.  
  78.         \text                   Find 'text' regardless of case
  79.         /text                   Scan for exact text match
  80.  
  81.  
  82.     Control key      Function
  83.     -----------      -------------------------------------------------------
  84.      Enter           continue to next page
  85.      ESCape          Display next matching file
  86.      HOME            restart from first block (top)
  87.      PgUp            scroll up one page
  88.      PgDn            scroll down one page
  89.  
  90.      left arrow      scroll left 20 columns
  91.      right arrow     scroll right 20 columns
  92.      up arrow        up one (previous) line
  93.      down arrow      down one (next) line
  94.  
  95.      ctl-HOME        restart from CURRENT (64k) block
  96.      ctl-PgUp        restart from first block (TOP)
  97.      ctl-PgDn        skip to end of file (BOTTOM)
  98.      ctl-left-arrow  reset scroll to column 1
  99.  
  100.      F1              Help - display summary of commands
  101.      F3              Find next occurrance of text
  102.      F10             Exit to DOS
  103.  
  104.      alt-F           change Foreground color
  105.      alt-B           change Background color
  106.                                                         LIST     Page 3
  107.  
  108.  Screen attributes
  109.  -----------------
  110.  
  111.            There are three classes  of attributes used.  One  for normal
  112.         display lines  - lines  2 to  24 -  another for  special lines -
  113.         lines 1 and 25, and a third for the Find/Scan color.  The border
  114.         is not changed.
  115.  
  116.         These attributes may be changed by using DEBUG:
  117.  
  118. |        at offset 194 = 09     ;lines 1 & 25, hi-lighted or lt.blue
  119. |        at offset 196 = 02     ;normal lines, green
  120. |        at offset 198 = 0C     ;attention when text found, red
  121.  
  122.         If these values don't match, you have a different version.
  123.         ----------------------------------------------------------
  124.  
  125.         For example, to change lines 1 and 25 to reversed video:
  126.  
  127.         A>debug list.com
  128.         -e194 70
  129.         -w
  130.         -q
  131.  
  132.  
  133.  Colors and attributes
  134.  ---------------------
  135.  
  136.        hex   Background Foreground      Monochrome
  137.        ---   ---------- ----------      ---------------------------
  138.         0    black      black           non-display
  139.         1    blue       blue            underlined
  140.         2    green      green           normal
  141.         3    cyan       cyan            normal
  142.         4    red        red             normal
  143.         5    magenta    magenta         normal
  144.         6    yellow     brown           normal
  145.         7    white      lt. grey        normal
  146.         8    black      dk. grey        normal
  147.         9    blue       lt. blue        high intensity/underlined
  148.         A    green      lt. green       high intensity
  149.         B    cyan       lt. cyan        high intensity
  150.         C    red        lt. red         high intensity
  151.         D    magenta    lt. magenta     high intensity
  152.         E    yellow     yellow          high intensity
  153.         F    white      white           high intensity
  154.                                                         LIST     Page 4
  155.  Scanning for text
  156.  -----------------
  157.  
  158. |          You may use  Find (\)  to search for text  regardless  of the
  159. |       case, or you may use Scan (/) to find an exact match.
  160.  
  161.            To scan for a character string, type a slash (/) followed  by
  162.         one or more (up to 32)  characters.  The scan text, but not  the
  163.         slash,  is  displayed  on  the  command  line.  The scan is case
  164.         sensitive.  That is, lower case scan text will only match  lower
  165.         lower case file text.
  166.  
  167. |          While  the  program  is  searching  for  the text, the bottom
  168. |       display line is changed to say "Scanning".
  169.  
  170.            If the text is found, the line containing it is displayed  as
  171.         a high-intensity line.
  172.  
  173.            If the text is NOT found, the bottom line (25) is changed  to
  174.         say '*** text not found ***', and the display remains unchanged.
  175.  
  176.            To find the next occurrance of the same text,  use the A)gain
  177.         command, or press the F3 key.
  178.  
  179.  
  180.  Restrictions
  181.  ------------
  182.  
  183. |          Some positioning is relative to the current block in storage.
  184.         The size of the block depends on the amount of memory available,
  185.         and up to 64K-bytes is allocated to the file buffer. The program
  186. |       requires at least 6K bytes.
  187.  
  188.         PC-DOS Version 2.0 or later is required.
  189.  
  190.         ANSI.SYS is NOT required.
  191.  
  192.  
  193.         Written by Vernon Buerg for the  IBM PC using DOS 2.0 and  is
  194.         supplied for public domain  use. All rights reserved.
  195.         Not for sale or hire.
  196.  
  197.                 Vernon D. Buerg
  198.                 456 Lakeshire Drive
  199.                 Daly City, CA 94015
  200.                 Work: (415) 991-0644
  201.                 Data: (415) 994-2944, 2am-10am PDT
  202.  
  203.         Lines beginning with | denote changes to the latest version.
  204.  
  205.         Version 4.1, April 27, 1984.
  206.         Version 4.15, June 2, 1984.
  207.         Version 4.2, July 14, 1984.
  208.         Version 5.0, August 10, 1984.
  209.         Version 5.1, August 27, 1984.
  210.         Version 5.2, September 29, 1984.
  211.         Version 5.4, March 22, 1984.
  212. |       Version 5.48, May 27, 1985.
  213. |           Corrects problem with Print and small files.
  214.  
  215. 
  216. sion 5.4, March 22, 1984.
  217. |       Version 5.48, May 27, 1985.
  218. |           Corrects problem with Print